home *** CD-ROM | disk | FTP | other *** search
/ PD Collection CD 1 / PD Collection CD 1.iso / programer2 / pari2 / pari / ArcReadme next >
Text File  |  1992-01-04  |  7KB  |  195 lines
  1. INTRODUCTION
  2.  
  3. This is an Archimedes port of GP and PARI.
  4.  
  5. PARI is a library of C functions for handling mathematical objects.
  6. This includes integers of any length, real numbers of any precision,
  7. p-adic numbers, integers mod n. It also includes polynomials, power series
  8. vectors and matrices of the above.
  9.  
  10. GP is a calculator that makes use of the PARI library to do calculations
  11. with the above. It has some programming features.
  12.  
  13. COPYRIGHT INFORMATION
  14.  
  15. GP and PARI are copyright
  16. C. Batut, D. Bernardi, H. Cohen and M. Olivier.
  17.  
  18. To use or distribute this package you must read and obey the conditions in
  19. the file pari.readme.
  20.  
  21. I have permission from the authors to distribute this Archimedes version.
  22. All the original files are included. Three files c.gp, c.es and h.genpari
  23. have small modifications that are used if RISC_OS is defined.
  24. I have had to change some filenames to RISC_OS names. 
  25. These files and their RISC_OS versions are listed below. See pari.other.FILES
  26. for what they contain.
  27.  
  28. I have also added the following files
  29.  
  30. pari.ArcReadme      This file
  31. pari.gp             Executable file of the gp calculator
  32. pari.RunGP          Exec file to start up gp
  33. pari.a.version_A    Assembler source for 'Level 0 kernel'
  34.                                  (for Wingpass assembler)
  35. pari.o.version_A    Assembled version of the above
  36. pari.Makefile       Makefile for !Make
  37.  
  38. OBTAINING THE DOCUMENTATION
  39.  
  40. You will first need to print out the TeX documentation. You will need a copy
  41. of Graeme Toal's Archimedes TeX.
  42. Drag the pari.tex.users directory on to the !TeX icon. Then drag it onto
  43. a suitable printer driver.
  44. To produce the index you will need to sort it by setting the current
  45. directory to pari.tex.users and doing
  46.           sort idx std -f
  47. I used sort from David Pillings C Toolkit disk.
  48. Then drag tex.index to !Tex and a printer driver.
  49.  
  50. USING GP
  51.  
  52. gp is a command line program. It needs to have version 3.75 of the shared
  53. C library and the floating point emulator loaded.
  54. The file pari.RunGP checks this before loading gp.
  55.  
  56. The easiest way to run gp is to put gp and RunGP in your library directory
  57. and type *RunGP.
  58.  
  59. gp uses a great deal of memory. The unsqueezed executable code is 483k.
  60. gp also helps itself to memory for a large stack and some other buffers.
  61. The default sizes for this version are 1000000 bytes stack, 200000 bytes
  62. prime table, 30000 bytes input buffer. In addition gp helps itself to 
  63. memory from the heap to store named variables and other things.
  64. Running the testin input with the default sizes takes 1920k.
  65. Fortunately Clib 3.75 allows it to help itself to more memory for these
  66. purposes.
  67. If you have sufficient memory you can run gp in a !SrcEdit task window.
  68. It is possible to run gp on a 1Mb machine, but it will run out of space if
  69. you try to do anything complicated. You will need to run it outside the 
  70. desktop and change the default sizes.
  71. Try changing the gp line in RunGP to
  72.              gp -s 120000 -p 2000 -b 2000
  73.  
  74. MAKING GP
  75.  
  76. To remake gp from the sources you can use the Makefile supplied if you
  77. have desktop C.
  78.  
  79.    It is possible to compile using the -pcc flag, this produces fewer
  80. error mesages, but the result is slightly larger and slower so I have 
  81. not done so.
  82.  
  83.    To compile you need to predefine a macro with -DRISC_OS
  84. to supress error messages with -wadfnv and to set !Make to ignore 
  85. return codes and continue after errors.
  86.  
  87. If link runs out of memory increase the next slot before running the 
  88. makefile again.
  89.  
  90. Additional targets in the Makefile are
  91.  
  92.           shrink     -   squeeze gp
  93.           tidy       -   delete .o. files, copy gp to $.library
  94.  
  95. If you want to use the PARI library you can make a library
  96. by dragging all the .o. files except gp to !LibFile
  97.  
  98. To use the library you should include the four pari header files
  99. in your source, predefine RISC_OS and supress warnings with -wdfvna.
  100. To compile the example supplied change <genpari.h> to "genpari.h"
  101.  
  102. ORIGINAL FILES
  103.  
  104. Unix name           RISC_OS name
  105.  
  106. Buglist             pari.other.Buglist
  107. Changes             pari.other.changes
  108. Changes1.31-1.35    pari.other.changes1
  109. FILES               pari.other.FILES
  110. INSTALLATION        pari.other.INSTALL
  111. Makefile.port       pari.other.Makefile_p
  112. Makefile.readline   pari.other.Makefile_r
  113. Makefile.sun3       pari.other.Makefile_s
  114. Makefile.sun4       pari.other.Makefile_4
  115. Newin1.36           pari.other.Newin1_36
  116. README              pari.README
  117. alglin1.c           pari.c.alglin1
  118. alglin2.c           pari.c.alglin2
  119. anal.c              pari.c.anal
  120. arith1.c            pari.c.arith1
  121. arith2.c            pari.c.arith2
  122. base.c              pari.c.base
  123. bibli1.c            pari.c.bibli1
  124. bibli2.c            pari.c.bibli2
  125. elliptic.c          pari.c.elliptic
  126. erreurs.h           pari.h.erreurs
  127. errmessages.c       pari.c.errmessage
  128. es.c                pari.c.es               (Modified)
  129. gen1.c              pari.c.gen1
  130. gen2.c              pari.c.gen2
  131. gen3.c              pari.c.gen3
  132. gen68k.h            pari.other.gen68k_h
  133. gencom.h            pari.h.gencom
  134. genpari68k.h        pari.other.genpari68k
  135. genpariother.h      pari.h.genpari          (Modified)
  136. genport.h           pari.h.genport
  137. gp.c                pari.c.gp               (Modified)
  138. gpreadline.c        pari.other.gpreadline
  139. helpmessages.c      pari.c.helpmsg
  140. init.c              pari.c.init
  141. mp.ami              pari.other.mp_ami
  142. mp.c                pari.c.mp
  143. mp.news             pari.other.mp_news
  144. mp.s                pari.other.mp_s
  145. pari.el             pari.other.pari_el
  146. pari.elc            pari.other.pari_elc
  147. pari.menu           pari.other.pari_menu
  148. pari.txt            pari.other.pari_txt
  149. plot.X              pari.other.plot_X
  150. plot.null           pari.other.plot_null
  151. plot.sun            pari.other.plot_sun
  152. plotdummy.c         pari.c.plotdummy
  153. polarit1.c          pari.c.polarit1
  154. polarit2.c          pari.c.polarit2
  155. sparc.s             pari.other.sparc_s
  156. testin              pari.testin
  157. testout             pari.testout
  158. trans1.c            pari.c.trans1
  159. trans2.c            pari.trans2
  160. trans3.c            pari.c.trans3
  161. version68k.c        pari.other.version68k
  162. versionport.c       pari.c.version
  163. versionsparc.c      pari.other.versionspa
  164.  
  165. tex/Makefile        pari.tex.Makefile
  166. tex/appa.tex        pari.tex.appa.tex
  167. tex/appb.tex        pari.tex.appb.tex
  168. tex/appc.tex        pari.tex.appc.tex
  169. tex/appd.tex        pari.tex.appd.tex
  170. tex/index.tex       pari.tex.index.tex
  171. tex/titlepage.tex   pari.tex.titlepage.tex
  172. tex/tutorial.tex    pari.tex.tutorial.tex
  173. tex/users.tex       pari.tex.users.tex 
  174. tex/usersch1.tex    pari.tex.usersch1.tex
  175. tex/usersch2.tex    pari.tex.usersch2.tex 
  176. tex/usersch3.tex    pari.tex.usersch3.tex
  177. tex/usersch4.tex    pari.tex.usersch4.tex  
  178. tex/usersch5.tex    pari.tex.usersch5.tex
  179.  
  180. example/Makefile    pari.example.Makefile
  181. example/Makesimple  pari.example.Makesimple
  182. example/mattrans.c  pari.example.mattrans_c
  183. example/squfof.gp   pari.example.squfof_gp
  184.  
  185. TO DO
  186.  
  187. It would be nice to implement high resolution graphics.
  188.  
  189. Let me know if you have any problems with or find any interesting uses for 
  190. gp or pari.
  191.  
  192. Chris Stretch
  193.                cdtp13%uk.ac.ulster.ucvax
  194.  
  195.